身份证识别 |
您所在的位置：网站首页 › php 百度云接口 › 身份证识别 |
|
接口描述
支持对二代居民身份证正反面所有8个字段进行结构化识别，包括姓名、性别、民族、出生日期、住址、身份证号、签发机关、有效期限，识别准确率超过99%；同时支持身份证正面头像检测，并返回头像切片的base64编码及位置信息。 同时，支持对用户上传的身份证图片进行图像质量和风险检测，是否存在正反颠倒、模糊、欠曝、过曝等质量问题，可识别图片是否为复印件或临时身份证，是否被翻拍或编辑，是否存在四角不完整、头像或关键字段被遮挡。 增值能力 详情 裁剪能力 头像检测与切片：返回头像切片的base64编码及位置信息 身份证检测与切片：返回身份证的base64编码及位置信息（去掉证件外围多余背景、自动矫正拍摄角度） 质量检测 身份证图片模糊检测 身份证关键字段反光或过曝光 身份证图片较暗或欠曝光 身份证边框/四角不完整告警 身份证头像或关键字段被遮挡/马赛克告警 风险检测 身份证复印件告警 临时身份证告警 身份证翻拍告警 身份证PS编辑告警 身份证证号不合法告警 身份证证号和出生日期、性别信息不一致告警视频教程请参见 身份证识别API调用教程（视频版） 在线调试您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。 请求说明请求示例 HTTP 方法：POST 请求URL： https://aip.baidubce.com/rest/2.0/ocr/v1/idcard URL参数： 参数 值 access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取”Header如下： 参数 值 Content-Type application/x-www-form-urlencodedBody中放置请求参数，参数详情如下： 请求参数 参数 是否必选 类型 可选值范围 说明 image 和url二选一 string - 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/jpeg/png/bmp格式 url 和image二选一 string - 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/jpeg/png/bmp格式，当image字段存在时url字段失效请注意关闭URL防盗链 id_card_side 是 string front/back -front：身份证含照片的一面-back：身份证带国徽的一面自动检测身份证正反面，如果传参指定方向与图片相反，支持正常识别，返回参数image_status字段为"reversed_side" detect_risk 否 string true/false 是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)检测功能，默认不开启，即：false。- true：开启，请查看返回参数risk_type；- false：不开启 detect_quality 否 string true/false 是否开启身份证质量类型(边框/四角不完整、头像或关键字段被遮挡/马赛克)检测功能，默认不开启，即：false。- true：开启，请查看返回参数card_quality；- false：不开启 detect_photo 否 string true/false 是否检测头像内容，默认不检测。可选值：true-检测头像并返回头像的 base64 编码及位置信息 detect_card 否 string true/false 是否检测身份证进行裁剪，默认不检测。可选值：true-检测身份证并返回证照的 base64 编码及位置信息 detect_direction 否 string true/false 是否检测上传的身份证图片方向，默认不检测。可选值：-true：检测 - false：不检测请求代码示例 提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。 提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。 BashPythonJAVAC++PHPC# curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard?access_token=【调用鉴权接口获取的token】' --data 'id_card_side=front&image=【图片Base64编码，需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded' # encoding:utf-8 import requests import base64 ''' 身份证识别 ''' request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/idcard" # 二进制方式打开图片文件 f = open('[本地文件]', 'rb') img = base64.b64encode(f.read()) params = {"id_card_side":"front","image":img} access_token = '[调用鉴权接口获取的token]' request_url = request_url + "?access_token=" + access_token headers = {'content-type': 'application/x-www-form-urlencoded'} response = requests.post(request_url, data=params, headers=headers) if response: print (response.json()) package com.baidu.ai.aip; import com.baidu.ai.aip.utils.Base64Util; import com.baidu.ai.aip.utils.FileUtil; import com.baidu.ai.aip.utils.HttpUtil; import java.net.URLEncoder; /** * 身份证识别 */ public class Idcard { /** * 重要提示代码中所需工具类 * FileUtil,Base64Util,HttpUtil,GsonUtils请从 * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72 * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2 * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3 * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3 * 下载 */ public static String idcard() { // 请求url String url = "https://aip.baidubce.com/rest/2.0/ocr/v1/idcard"; try { // 本地文件路径 String filePath = "[本地文件路径]"; byte[] imgData = FileUtil.readFileByBytes(filePath); String imgStr = Base64Util.encode(imgData); String imgParam = URLEncoder.encode(imgStr, "UTF-8"); String param = "id_card_side=" + "front" + "&image=" + imgParam; // 注意这里仅为了简化编码每一次请求都去获取access_token，线上环境access_token有过期时间， 客户端可自行缓存，过期后重新获取。 String accessToken = "[调用鉴权接口获取的token]"; String result = HttpUtil.post(url, accessToken, param); System.out.println(result); return result; } catch (Exception e) { e.printStackTrace(); } return null; } public static void main(String[] args) { Idcard.idcard(); } } #include #include // libcurl库下载链接：https://curl.haxx.se/download.html // jsoncpp库下载链接：https://github.com/open-source-parsers/jsoncpp/ const static std::string request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/idcard"; static std::string idcard_result; /** * curl发送http请求调用的回调函数，回调函数中对返回的json格式的body进行了解析，解析结果储存在全局的静态变量当中 * @param 参数定义见libcurl文档 * @return 返回值定义见libcurl文档 */ static size_t callback(void *ptr, size_t size, size_t nmemb, void *stream) { // 获取到的body存放在ptr中，先将其转换为string格式 idcard_result = std::string((char *) ptr, size * nmemb); return size * nmemb; } /** * 身份证识别 * @return 调用成功返回0，发生错误返回其他错误码 */ int idcard(std::string &json_result, const std::string &access_token) { std::string url = request_url + "?access_token=" + access_token; CURL *curl = NULL; CURLcode result_code; int is_success; curl = curl_easy_init(); if (curl) { curl_easy_setopt(curl, CURLOPT_URL, url.data()); curl_easy_setopt(curl, CURLOPT_POST, 1); curl_httppost *post = NULL; curl_httppost *last = NULL; curl_formadd(&post, &last, CURLFORM_COPYNAME, "id_card_side", CURLFORM_COPYCONTENTS, "front", CURLFORM_END); curl_formadd(&post, &last, CURLFORM_COPYNAME, "image", CURLFORM_COPYCONTENTS, "【base64_img】", CURLFORM_END); curl_easy_setopt(curl, CURLOPT_HTTPPOST, post); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback); result_code = curl_easy_perform(curl); if (result_code != CURLE_OK) { fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(result_code)); is_success = 1; return is_success; } json_result = idcard_result; curl_easy_cleanup(curl); is_success = 0; } else { fprintf(stderr, "curl_easy_init() failed."); is_success = 1; } return is_success; } |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |